Raise, methode

           

Genereert een runtimefout.

Syntaxis

object.Raise number, source, description, helpfile, helpcontext

De methode Raise heeft de volgende objectkwalificatie- en benoemde argumenten:

Argument Beschrijving
Object Vereist. Altijd het object Err.
number Vereist. Een Long-integer die de aard van de fout aangeeft. Visual Basic-fouten (zowel in Visual Basic gedefinieerde als door de gebruiker gedefinieerde fouten) liggen tussen 0 en 65535. Het bereik 0-512 is gereserveerd voor systeemfouten, het bereik 513-65535 is beschikbaar voor door de gebruiker gedefinieerde fouten. Wanneer u de eigenschap Number instelt op uw eigen foutcode in een klassenmodule, voegt u uw foutcodenummer toe aan de constante vbObjectError. Als u bijvoorbeeld het foutnummer 513 wilt genereren, wijst u vbObjectError +513 toe aan de eigenschap Number.
source Optioneel. Een tekenreeksexpressie met de naam van het object of de toepassing waardoor de fout oorspronkelijk is gegenereerd. Als u deze eigenschap instelt voor een object, gebruikt u de vorm project.klasse. Als bron niet is opgegeven, wordt het programma-id van het huidige Visual Basic-project gebruikt.
description Optioneel. Een tekenreeksexpressie die de fout beschrijft. Als niets is opgegeven, wordt de waarde in Number gecontroleerd. Als deze kan worden toegewezen aan een runtimefoutcode van Visual Basic, wordt de tekenreeks die door de functie Error als resultaatwaarde zou worden gegeven, als Description gebruikt. Als er geen Visual Basic-fout is die correspondeert met Number, wordt de tekst "Door de gebruiker gedefinieerde fout" gebruikt.
helpfile Optioneel. Het volledige en geldige pad naar het Help-bestand dat informatie over deze fout bevat. Als niets is opgegeven, wordt het volledige pad en de bestandsnaam van het Visual Basic Help-bestand gebruikt.
helpcontext Optioneel. Het context-id voor een onderwerp in helpfile dat informatie over de fout bevat. Als niets is opgegeven, wordt het Visual Basic Help-context-id gebruikt dat correspondeert met de eigenschap Number, als die bestaat.

Notities

Alle argumenten zijn optioneel, behalve number. Als u Raise echter gebruikt zonder argumenten, terwijl de eigenschappen van het object Err instellingen bevatten die niet zijn gewist, worden die instellingen als waarden voor uw fout gebruikt.

Raise wordt gebruikt om runtimefouten te genereren en kan in plaats van de instructie Error worden gebruikt. Raise is met name handig om fouten te genereren tijdens het schrijven van klassenmodules omdat het object Err namelijk meer gedetailleerde informatie geeft dan mogelijk is als u fouten genereert met de instructie Error. Met de methode Raise kan bijvoorbeeld de oorspronkelijke generator van de fout worden opgegeven in de eigenschap Source, on line Help voor de fout worden weergegeven, enzovoort.